================================================================================
Public Whore – Tat Extension
Naming & Priority Manual
================================================================================

This extension replaces the old fixed "one label / one symbol per hold" system.
Tattoos are taken from the SlaveTats section named exactly:

    Public Whore

e.g. {"name": "Chest - PW Loan Public Use", "area": "Body", "section": "-->Public Whore<--", "texture": "Alpia Scribbles V2\\PW Replacer\\1C - PW Loan Public Use.dds"},


Any JSON pack can add entries to that section. The mod does not care about the
file name of the JSON, only about the "section" field and the "name" field.


--------------------------------------------------------------------------------
1. BASIC NAME FORMAT
--------------------------------------------------------------------------------

Recommended pattern:

    [Position] - PW [Hold or Generic] [Description]
	
If no Hold in name or no Generic fallback to Generic pool.

Examples that work with this pack:

    Throat - PW Dawnstar Choker
    Chest - PW Whiterun
    Pubic - PW Generic Skyrim
    Lower Back - PW Markarth Tramp
    L Breast - PW Riften Blackhand
    Shoulders - PW Windhelm Crest
	
No two "Shoulders" or whatever get applied kinda like in the Rape Tats mod.

Rules of thumb:
  - Put the body position first (before the first " - ").
  - Put the hold name (or the word Generic) somewhere in the name if neither is present will be treated as Generic non hold specific.
  - Keep the section as "Public Whore".

--------------------------------------------------------------------------------
2. POSITION PREFIX (anti-overlap when applying several tattoos)
--------------------------------------------------------------------------------

The position prefix is the text BEFORE the first " - ".

    "Throat - PW Dawnstar Choker"     →  prefix = Throat
    "Chest - PW Markarth"             →  prefix = Chest
    "L + R Breast - PW Windhelm..."   →  prefix = L + R Breast
    "Pubic - PW Generic Skyrim"        →  prefix = Pubic

When "Max Tattoos on Start" is higher than 1, the mod will not apply two
tattoos that share the same position prefix in the same batch.

So this is fine in one batch:
    Throat + Chest + Pubic + Lower Back

This is NOT allowed in one batch:
    two different "Chest - ..." tattoos


--------------------------------------------------------------------------------
3. GENERIC vs HOLD SPECIFIC
--------------------------------------------------------------------------------

MCM option "SlaveTat Type":

  Generic
      Uses tattoos that count as Generic (see rules below).

  Hold Specific
      Uses tattoos that match the hold where the player becomes Public Whore
      (Dawnstar, Falkreath, Markarth, Morthal, Riften, Solitude, Whiterun,
       Windhelm, Winterhold).


How a tattoo is classified
--------------------------

The mod looks at the PREFIX first (text before " - ").

  1) If the prefix contains "Generic"
        → always counts as Generic
        → if the prefix also contains a hold name, it also counts for that hold

  2) If the prefix contains a hold name (and not Generic)
        → counts only for that hold

  3) If the prefix has neither Generic nor a hold name
        → the WHOLE name is scanned for hold names
        → if a hold is found → that hold only
        → if no hold is found → Generic (fallback)


Examples
--------

Name                                          Generic?   Hold Specific?
---------------------------------------------------------------------------
Pubic - PW Generic Skyrim                     Yes        No
Lower Back - PW Generic Skyrim                Yes        No
Throat - PW Dawnstar Choker                   No         Dawnstar only
Chest - PW Whiterun                           No         Whiterun only
PW Generic Whiterun - Shared Mark             Yes        Whiterun too
Throat Generic - Public whore tramp stamp     Yes        No
Throat - Public whore tramp stamp             Yes*       No
Throat - Public whore tramp stamp generic     Yes*       No
Shoulders - PW Barcode Dawnstar               No         Dawnstar only
  (* yes via fallback: no hold name or generic anywhere in the name)

In other words adding "Generic" is not needed unless you want to force a Hold specific tat to also be treated as Generic.

--------------------------------------------------------------------------------
4. APPLICATION ORDER
--------------------------------------------------------------------------------

When the player becomes Public Whore:

  1. All tattoos in section "Public Whore" are collected.
  2. They are filtered by the current MCM mode (Generic or Hold Specific).
  3. From that filtered list:
        Max Tattoos on Start = 1  → one random tattoo
        Max Tattoos on Start = 2+ → !up to! that many tattoos, each with a
                                    different position prefix

If fewer matching tattoos exist than the slider value, as many as possible
are applied. Missing JSON or an empty filtered list shows a notification.


--------------------------------------------------------------------------------
5. REMOVAL
--------------------------------------------------------------------------------

When the Public Whore duty ends, every tattoo in the "Public Whore" section
is removed from the player. Other SlaveTats sections are left alone.


--------------------------------------------------------------------------------
6. QUICK CHECKLIST FOR NEW TATTOOS
--------------------------------------------------------------------------------

  "section": "Public Whore"
  Name starts with a clear position if you want to avoid overlap (Throat, Chest, Pubic, ...)
  Hold name in the name for hold-specific tattoos
  OR no hold name / "Generic" in the prefix for generic tattoos
  Unique position prefixes if you want several to apply together

That is all the extension needs. If you don't want any tattoo add/remove as you please its not rocket science.
